
  Basilisk II
  A 68k Macintosh emulator

  Copyright (C) 1997-2005 Christian Bauer et al.


License
-------

Basilisk II is available under the terms of the GNU General Public License.
See the file "COPYING.txt" that is included in the distribution for details.


Overview
--------

Basilisk II is an Open Source 68k Macintosh emulator. That is, it enables
you to run 68k MacOS software on you computer, even if you are using a
different operating system. However, you still need a copy of MacOS and
a Macintosh ROM image to use Basilisk II.

Basilisk II/JIT is Basilisk II with the JIT (Just In Time) Compiler
that Bernd "Bernie" Meyer developed for UAE.


Documentation
-------------

Please read the other Basilisk II documentation in the following directories:
- General documents
- Windows-specific documents


Windows port
------------

This is a new Windows port derived from Lauri's original port and the current
Basilisk II tree that is to become version 1.0. The major change resides in
the fact that it now requires an SDL library. You can get it at:
<http://www.libsdl.org/download-1.2.php>

The advantage is that's portable and has up-to-date features from the Unix
versions, namely runtime depth and resolution switching. However, graphics
performance is currently suboptimal. Everyone is invited to rewrite the
graphics subsystem with DirectX.

Also note that Windows 9X support is dropped. You will need at least a Windows
NT 4 kernel, though it was tested with Windows XP SP1.

Known issues:
- "My Computer" icon is no longer available
- "Keyboard type" option is always set to 5
- "Get Hardware Value" option is always set to true
- You may need to boot with a CD-ROM in the drive if you intend to use it


GUI Preferences Editor
----------------------

The GUI Preferences Editor is not updated to take into account JIT-specific
preferences items. Therefore, you may have to re-edit "BasiliskII_prefs" if
that tool wiped out your preferences

Relevant prefs items for the JIT compiler are:
- jit <boolean>: enables the JIT compiler
- jitlazyflush <true>: enable lazy invalidation of the translation cache
- jitcachesize <integer> : specifies the translation cache size in KB
- jitfpu <boolean> : specifies whether to compile FPU instructions or not

The values I would recommend for now are:
	jit true
	jitlazyflush true
	jitcachesize 8192
	jitfpu true
	cpu 4
	fpu true

Also note that "framesleepticks" is replaced with the "frameskip" option.
The former uses millisecond resolution whereas the latter represents the
number of frames that are skipped prior to rendering the next one. In other
words, a frameskip set to 0 means to always render the frame at each
interrupt. An interrupt kicks in at 60 Hz, i.e. 60 times per second, that's
approximately 16 ms.

Gwenole Beauchesne
gb.public@free.fr